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Description 

Background Of The Invention 

s [0001] This invention relates, generally, to a method for controlling a network element and, more particularly, to a 
method for remotely controlling the network by communications through the network. 

[0002] Network management systems in which network elements, or management agents, are remotely controlled 
from a remote, management work station by means of communications between the management work station and 
the managed network elements sent through the network are known. Such known network management systems 
10 employ a special communication protocol for communications between the remote work station running a management 
program and an element management server that contains a management information base that defines the interface 
between the work station and the network elements. 

[0003] Known systems such as (Hewlett Packard HP-OV NNM or DM, Sun Microsystems Solstice) present an in- 
terface where the client application must poll the network element when status is needed. In these systems, the polling 
is may not be coordinated and is replicated for each client, if each client is interested in the same attributes. Also, each 
of the clients receive the full "results for each polling cycle (even if there was no change from the last cycle), increasing 
the bandwidth used to communicate between the client application and the network element, as well as creating ad- 
ditional processing overhead due to the replicated polling at the network element. 

20 Summary Of The Invention 

[0004] A method is provided for controlling a network element from a remote work station connectable to the network. 
The method provides for registering the network element for attributes to be tracked, and polling for attributes associated 
with the network element only if the client requests the monitoring of the network element. Changes in attributes are 
25 reported when the client requests notification of changes in attributes. For attributes polled for a plurality of clients, 
changes in the attributes to one of the plurality of clients requesting notification of changes in the attributes are reported. 
[0005] The method further provides for polling once for a plurality of clients that registers for the same attributes and 
reporting asynchronously changes in the attributes to a plurality of clients. 

[0006] Another aspect of the invention provides for running an object oriented program at the remote work station 
30 to control an object associated with the controllable network element, translating interface operations generated by 
the work station during the running of the object oriented program to corresponding translated interface operations in 
an object oriented language associated with the object being controlled, and connecting the corresponding translated 
interface operations through the network to an object server to control the object associated with the network element 
in accordance with the translated interface operations. 
35 [0007] These and other features and advantages of the present invention will become apparent from the following 
detailed description, the accompanying drawings and the appended claims. 

Brief Description Of The Drawings 

40 [0008] The foregoing advantageous features will be described in detail and other advantageous features of the in- 
vention will be made apparent from the detailed description of the preferred embodiment of the invention that is given 
with reference to the several figures of the drawings, in which: 

Fig. 1 is a functional block diagram of the preferred embodiment of a management system using the preferred 
45 network element control method of the present invention; 

Fig 2 is a functional block diagram of the preferred embodiment of the translating interface shown as a single 
functional block in Fig. 1; 

so Fig. 3 is a functional block diagram illustrating the interface with the controlled network element that is visible to 

object oriented client management application at the work station of Fig.1; 

Fig. 4 is a table of a plurality of service objects that interact with the client management application run at the work 
station of Fig.1 ; 

55 

Fig. 5 is a table of a plurality of call back functions performed at the translating interface of Fig.2; 

Fig. 6 is a table of the different fundamental data types capable of being translated by the translating interface of 
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Fig. 7 is a block diagram showing the relationship between client application-specific service object, and the internal 
service representative of managed object instances; 

5 

Fig. 8 is a table summarizing filter criteria that is valid for each event category; and 

Fig. 9 is a table defining specific exceptions with an EMAPI exception code containing one of the listed values. 
10 Detailed Description 

[0009] This invention provides an application programming interface (API) and protocol that provides for efficient 
communication between a distributed client application and an element management server independent of the com- 
munication protocol to the network element. The Element Management Application Programming Interface (EMAPI) 

15 provides the following benefits over known management system. The invention has application in the management of 
a telecommunication network^ element. For more information regarding such a management of a telecommunication 
network element refer to commonly owned U. S. patent application serial number 09/088,463, entitled "Method for 
Computer Internet Remote Management of a Telecommunication Network Element" by William E. Barker, Lisa M. 
Connelly, Marvin A. Eggert, Michael P. Foley, Kenneth R. Macfarlane, Philip M. Parsons, Girish Rai, Jerome E. Rog, 

20 and Kurt A. Vangsness, filed on May 31, 1998, the disclosure of which is hereby incorporated by reference. 

• Efficient use over low bandwidth connections. Client applications register for network element information they 
wish to track and after an initial set of data only receive incremental updates (deltas) when there are changes. 

25 • Centralized polling of attributes. Attributes are only polled if a client exists that has registered to monitor the attribute. 

If multiple clients register for the same attribute(s), the polling is not repeated for the clients-only a single polling 
cycle is performed. 

[0010] The invention is used in an operations, administration and maintenance system 20 as shown in Fig. 1. The 
30 system 20 includes a PC or workstation 22, an element management server (EMS) 24, an interface in accordance with 
the invention 26 , located between the workstation 22 and an object server 25. An application processor 28 is connected 
to the element management server 24. 

[0011] The workstation 22 includes a web browser 30 which is the interface to the client and is a host for JAVA applets 
32 and web browser HTML 35 which is a hypertext markup language. 
35 [0012] The system 20 operates on a cluster computing environment, and leverages off-the-shelf technology to enable 
additional customers visible features, while extending to subsequent releases and other projects, with minimal in- 
creased cost. System 20 is provided through the web browser interface and a SNMP based element management 
platform. 

[0013] A client executes applications via web pages at the workstation 22. The client makes requests for various 

40 views of the network status by making selections through the web browser 30. The web browser requests pages from 
the web server 28 which transmits HTML pages that contain instructions to load and run the appropriate JAVA applet 
32. One the applet starts, it communicates with the object server 25 through the interface 26 to perform initialization 
and to request initial configuration and status information that is appropriate for the current requested view. The JAVA 
applet 32 then registers with the object server 25 for subsequent notifications of changes to configuration and status 

45 that it requires to keep the view up to date. The client may perform commands to request various maintenance oper- 
ations on the network element 28. These commands are converted into appropriate requests through the interface 26 
and perform operations on the object server 25. The commands are then translated into SNMP and are transmitted to 
the network element 28 through the SNMP library 33. Acknowledgements and command responses from the network 
element 28 are transmitted through the SNMP library 33, are converted to events by the object server 25 and transmitted 

50 to originating JAVA applet 32 through the use of callbacks defined by the interface 26. 

[0014] In one embodiment of the invention, as shown in Fig. 3, client applications in JAVA applets 32 include an 
active alarm list browser, a system alarm survey and a network element detailed status display. Client applications 
communication with the web server 28 via the interface 26 in accordance with the invention, to the element manager 
through a distributed object request architecture such as CORBA. The interface 26 provides a constant interface to all 

55 managed objects in the network, and hides the implementation details associated with the element manager platform. 
[0015] The interface 26 (EMAPI) is the definition of objects, attributes and operations that comprise the protocol used 
between client applications and the server to manage network elements. The EMAPI uses the industry standard COR- 
BA to provide distribution of the objects and their operations and to allow for the implementation of the client and server 
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to be in different programming languages and on different computer architectures. 

[0016] The client interface to the server and the managed object attributes is described in the interface 26 and man- 
aged object notation provides a consistent model of ail managed objects in the network, hiding the implementation 
details associated with the element manager platform from client applications, thus clients do not need to know the 

5 underlying protocol to the network elements. Managed objects specific logic is encapsulated within the managed object 
instead of scattered throughout various applications thus simplifying client application development. 
[001 7] Each physical, selected non-physical and logical component in the network is modeled as a managed object, 
which the Server makes visible to distributed client applications through the facilities of the Common Object Request 
Broker Architecture (CORBA). EM clients need only be concerned about the attributes and operations defined for each 

10 application managed object, and not the details of network-level protocol and the server infrastructure required to 
support object services. 

EMAPI Object Definition 

/s [0018] Fig. 3 illustrates all of the interfaces visible to client applications which does not depict process or processor 
boundaries, which are made transparent by the client and server object request brokers (ORBs). Application services 
are provided through object interfaces formally defined in the CORBA Interface Definition Language (IDL). The IDL 
specification of the interfaces described in this document is provided in the Appendix A. 

[0019] The service objects resident on the server with which client applications will interact are shown in Fig. 4. 
20 [0020] C lient applications which register for real-time status updates or notification of events, alarms or configuration 
changes must provide a reference to a local callback object which the server will use to propagate information asyn- 
chronously. The callback interfaces defined in the interface 26 are shown in Fig. 5. Classes which implement these 
interfaces must be defined and instantiated in client code. 

25 Data Representation 

[0021] There are several fundamental data types defined in the interface 26 : which fall into one of the two categories 
shown in Fig 6. 

30 Session Management 

[0022] Each EM client session is logically associated with a unique login-host combination. Multiple client applications 
may be associated with the same session, though only one need be registered for the session to be considered active. 
Session and application identifiers are assigned by the User Session Manager to track resources used by the client, 

35 and in future releases, to correlate client access permissions with operation requests. Applications may or may not 
cross process boundaries. For example, multiple instances of the EMS Command Line Interface (CLI) application 
registered with the same login and host name will share the same session id, but each process is associated with a 
different application id In the EMS Graphical User Interface, all application frames execute in the same process space 
(albeit in different Threads), yet each frame is associated with a distinct application id. Note that each client application 

•to is required to independently register a periodic heartbeat to validate for the Server that its associated resources are 
still needed 

[0023] The UserSession service object provides the following interfaces: 

• startApplication 

45 This method must be invoked for each client application initialization. 

• stopApplication 

A client invokes this method to notify the Server that a target application is terminating, and its associated 
resources should be released. 

50 

• stop 

This method may be used to deregister all applications associated with the same session identifier. 

• heartbeat 

55 

[0024] This method must be invoked at least every UserSession: : Heartbeat Period seconds to avoid a timeout con- 
dition which, when detected by a Server audit, will result in the release of all resources utilized by an application. 
[0025] Refer to the description of interface UserSession in the attachment for additional details. 
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[0026] A managed object (MO) is an abstract representation of a physical or logical resource which may be managed 
by the EMS, such as a network element, maintenance unit or data link. The EM Server will implement one application- 

5 specific service object for each type of physical or logical resource to be managed. Each of these service objects 
defines a set of attributes which identify managed object properties, as well as the operations which may be performed 
on a specified managed object instance. (The decision to provide access to instance information through a single 
"service object 0 stems from the fact that current ORB implementations become unstable when managing very large 
numbers of remote references.) Fig. 7 depicts the relationship between Client, application-specific service object, and 

10 the internal Server representation of managed object instances. 

[0027] Each managed object service class is uniquely identified by a ClassCode. Each managed object instance is 
uniquely identified by an Instld. Any object instance in the system may be uniquely referenced by a managed object 
identifier (Oid), which is the combination of ClassCode and Instld. 

[0028] Managed object status information is reported by a service object as a sequence of attribute code-value pairs. 
is Each attribute value is defined as a union of all of the interface 26 fundamental data types described in Fig. 6. 

[0029] Configuration information is reported as a sequence of ConfigData structures, which are defined to contain: 

• network element instance id 
20 • managed object instance id 

• a managed object key list reported as a sequence of attribute-value pairs- when length is greater than 0, the key 
list specifies the associated logical identifiers (Logicallds) 

25 [0030] Each managed object service class must implement the MO interface, which defines the following configu- 
ration and status services: 

• viewConfig 

A client uses this method to obtain the current EMS view of the managed object configuration for a specified 
30 network element instance. Note that the reserved instance identifier Anylnstance may be used to obtain configu- 

ration information for all network elements. 

• notifyConfig 

A client may also register for an initial view of managed object configuration information and notification of 
35 subsequent changes via callback. The initial view is returned with a notification type CONFIGJNIT. Subsequent 

changes are reported with type CONFIG_CREATE or CONFIGJDELETE. 

• cancelNotify 

A client uses this method to cancel registration for managed object configuration notifications associated with 
40 a specified client application. 

• getPersistent 

A client may use this method to retrieve the set of attribute codes (SeqAttrCode) identifying all "persistent" 
data maintained by this service object. Values for persistent attributes of each managed object instance are stored 
45 and kept current irrespective of any client requests. 

• getAttrSpec 

A client may use this method to retrieve the name and codes of all attributes defined for a target service class 
(currently used for debugging only). 

50 

• getKeySpec 

A client may use this method to retrieve the set of codes (SeqAttrCode) identifying the attribute(s) which 
represents the logical identifier(s) of any instance of the target class. 

55 • viewStatus 

A client may invoke this method to obtain the EMS view of the current values for a specified set of persistent 
attributes for a specified managed object instance. 
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• getStatus 

A client may use this method to register for a snapshot of current status information. This interface differs from 
the previous one in that the requested attribute list may specify any managed object attribute codes— not just those 
associated with persistent data, and the information is returned via client status callback (StatusCB). 

5 

• startUpdate 

A client may also register for an initial view and notification of any updates to a list of selected attributes for a 
specified managed object instance. In this case, an initial view is reported via client callback with a notification 
type STATUSJNIT. Subsequent changes are reported with type STATUS_CHANGE. Note that managed object 
10 instance deletions are reported only through configuration change notification to avoid a potential flurry of client 

status callbacks when a network element is unequipped. 

• stopUpdate 

A client uses this method to cancel registration for managed object status updates associated with a specified 
is client application. 

• getlnst 

A client may use this method to obtain a managed object instance identifier for a specified network element 
instance id and managed object key list. 

20 

[0031] Note that each method requires a client session application identifier (SessionAppId) to validate user access. 
In the case of configuration or status change notification registration, this identifier is also used to keep track of the 
additional server resources utilized while the client application is active. 

[0032] Refer to the description of interfaces MO, ConfigCB & StatusCB in the attachment for additional details. 
Network Element Level Managed Objects 

[0033] Each network-element level managed object must also implement the NEMO interface which defines addi- 
tional network-element level configuration services: 

viewNEconfig 

[0034] A client may invoke this method to obtain the current EMS view of the network element configuration. 
35 • notify NEconfig 

A client may also register for an initial view of network element-level managed object configuration information 
and notification of subsequent changes via callback. The initial view is returned with a notification type 
CONFIGJNIT. Subsequent changes are reported with type CONFIG_CREATE or CONFIG_DELETE. 

40 • cancelNEnotify 

A client application should use this method to cancel registration for network element managed object config- 
uration updates. 

• getNEinst 

45 A client may invoke this method to retrieve the NEMO instance identifier of the network element associated 

with a specified logical id. 

• getLogicalld 

A client may invoke this method to retrieve the logical identifier of the network element associated with a 
50 specified NEMO instance id. 

• getContainment 

A client may invoke this method to obtain a sequence of containment information for the target NEMO, where 
each entry in the sequence contains the name, class code and CORBA reference to a contained service class 
ss object. 

[0035] Note that each method requires a client session application identifier to validate user access. In the case of 
configuration change notification registration, this identifier is also used to keep track of the additional server resources 
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utilized while the client application is active. 

[0036] Refer to the description of interfaces NEMO & NEconfigCB in the attachment for additional details. 
Descriptive Entity Objects 

[0037] Application objects of this type are defined to provide type and attribute information for abstract entities, such 
as data communicated between the EMS and network elements which are not part of a managed object description 
(e.g. SNMP trap definitions and command groups). Descriptive entity objects provide no implementation-they are de- 
fined in application-specific IDL and known by client applications at compile time. 



Event Distributor 

[0038] An event is reported as a combination of the following: 
is 1. A header, which contains information of most general interest: 

• Time of the event 

• Event category defined to be one of the following: 

* Alarm Set 

* Alarm Clear 

25 * Command Acknowledgment 

* Command Response 

* Configuration Change 

30 

* Informational Message 

* Initialization 
35 * State Change 

• Network element object identifier 

• Network element alarm level-meaningful only for alarm set 

40 

• Maintenance unit object identifier (if applicable) 

• Maintenance unit alarm level-meaningful only for alarm set 

45 • A command identifier (Cmdld) defined as a user session id & command sequence number-meaningful 

only for command acknowledgment & response; 

1 . Event data defined as a sequence of structures which contain: 

50 • A ClassCode of a managed object, network element or descriptive entity 

• A sequence of attribute code-value pairs 

[0039] Client applications may request a copy of the event stream, as processed by the event distributor, filtered on 
55 information specified in the event header. Filter wildcards are implemented with n out-of-band° values: 

• Any Category 
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• Any Class 

• Any Instance 

• Any Alarm 

• Any Cmd 

[0040] The table in Fig. 8 summarizes which filter criteria are valid for each event category: 

[0041] The event distributor processes filters by examining the specified category and AND'ing together valid criteria. 
Clients may simulate OR operations by registering multiple filters. 
[0042] The EvtDist service object implements the following client interfaces: 

• RegisterFilter 

15 A client uses this method to register an event filter A filter identifier is returned. 

• CancelFilter 

A client invokes this method to remove a specified event filter, using the filter id returned from the associated 
registration. 

20 

[0043] Note that each method requires a client session application identifier to validate user access. 
[0044] Refer to the description of interfaces EvtDist & EventCB in the attachment for additional details. 

Alarm Manager 

25 

[0045] Alarm information is reported as a sequence of AlarmData structures which contain: 

• The ClassCode of a managed object which defines a network-element specific alarm record. 

Note that in the first release of the EMS, only one network element active alarm table is defined (ApAc- 
30 tiveAlarms). 

• A sequence of alarm records, each of which contains an alarm instance identifier and sequence of attribute code- 
value pairs. 

Client applications may request a copy of all active alarms filtered on any combination of the following 

35 

• Network element 

• Maintenance unit 
40 • Alarm level 

[0046] Similar to the interfaces provided by the event distributor, out-of-band values may be used to represent wild- 
cards. 

[0047] Since managed object instance information may not be available at the time an alarm is reported, the actual 
45 alarm filter criteria are specified in terms of logical identifiers. Logical ids are integer values which represent the logical 
numbers of devices and interfaces (e.g. AP 4). The correlation between logical ids and managed object instance iden- 
tifiers is provided in the configuration information made available by each managed object service object, and through 
the utility method getlnst. Refer to the section on Managed Objects for additional details. 

[0048] The following AlarmManager client interfaces are written specifically for the Active Alarm List application: 

50 

• RequestAlarms 

A client invokes this method to register a filter for active alarms. 

• ChangeFilter 

55 A client may invoke this method to change filter criteria. 

• RefreshAlarms 

A client may invoke this method to refresh the active alarm list. 
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• CancelAlarms 

A client should invoke this method to de-register a filter. 

[0049] All operations except for de-registration return all active alarms filtered on the specified criteria. Also, each 
5 of these methods requires a valid client session application identifier to validate user access, and to keep track of the 
additional server resources which may be utilized while each client is active. 
[0050] The following AlarmManager interface may be used by any client application (e.g. CLI): 

• opAlarm 

10 Through client implementations of event callbacks used to process command acknowledgements and re- 

sponses (the same EventCB reference may be used in both cases), this method returns either a list of all active 
alarms in the system or just those associated with a target network element. 

[0051] Refer to the "description of interfaces AlarmManager, AlarmCB & EventCB in the attachment for additional 
is details. 

Exceptions 

[0052] Exceptions are used for consistent and structured error handling in both the EM Server and Client. 
20 [0053] The CORBA specification defines many system exceptions: • 

• BAD_PARAM 

• INV_OBJREF 

25 

• NCLPERMISSION 

• BAD_OPERATION 
30 • OBJ_ADAPTER 

• ♦♦♦ 

[0054] Refer to "The Common Object Request Broker: Architecture and Specification" for an exhaustive list of mne- 
35 monies and the associated exception descriptions. 

[0055] Vendor-specific object request broker exceptions are also defined (using the Minor identifier of the SystemEx- 
ception): 

• NO_l T_D AE MONLPORT 

40 

• LICENCE_EXPIRED 

• m 

45 [0056] Currently, the EMS uses lona's Orbix product. Refer to the "Orbix 2.3c Reference Guide" for an exhaustive 
list of mnemonics and the associated exception descriptions. 

[0057] In most cases, exceptions will be treated as fatal errors by Client code resulting in application termination. 
[0058] An interface 26-specific exception is also defined as an Exception Code containing one of the following values 
shown in Fig. 9. 

so 
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APPENDIX A- Emapi.idl 

tfifndef _EMAPI_IDL 
^define _EMAPI_IDL 

// 

// File: Emapi.idl 
// 

// Description: CORBA IDL file for the Element Manager API. All client 
// visible interfaces that are common to all applications of the 

EMS 

// are described here. 

// 

// interfaces which are referenced before they are defined 

interface ConfigCB; 

interface StatusCB; 

interface NEconfigCB; 

interface EventCB; 

interface AlarmCB; 



/ / s ome 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 



of the more commonly used ASN.l standard types 



boolean 
long 

unsigned long 

sequence<octet> 

unsigned long 

unsigned long 

unsigned long 

octet 

octet 



AsnlBoolean; 
Asnllnteger ; 
AsnlUInteger; 
AsnlOctet ; 
AsnlTimeticks ; 
AsnlGauge; 
AsnlCounter ; 
AsnllpAddress [ 4] ; 
AsnlNull; 



sequence<unsigned long> AsnlOid; 



// logical identifier—one or more attributes of this type may be 
defined 

// for any managed object to provide a logical identity (e.g. 
application 

// processor number/ RCS number) 

typedef Asnllnteger Logicalld; 

typedef sequence<LogicalId> SeqLogicalld; 

// definition of an object identifier 
typedef long ClassCode; 
typedef unsigned long Instld; 



struct Oid { 
ClassCode 
Instld 

} ; 



classld; 
instld; 



// reserved class id 

const ClassCode AnyClass 



= -1; 



// reserved instance id's 



const Instld 
const Instld 
const Instld 



Nulllnstance =* 0; 
Any Instance = 1 ; 

MaxRsvdlnst = 1 ; 
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// instance id associated with singleton objects (e.g. System) --note 
that 

// this is the first id normally assigned 

const Instid Singletonlnst = MaxRsvdlnst + 1; 

// reserved logical id 

const Logicalld AnyLogicaild = -1; 

// application identifier 
typedef long Appid; 

// reserved application id's 

const Appid NullAppId = -1; 

const Appid AnyAppId = -2 ; 

// applicationAsession identifier 
struct SessionAppId { 

Instid session; 
Appid app; 

} ; 

// maximum number of applications active per single user session 
const short MaxSessionApps = 10; 

// command identifier 
25 typedef long CmdSeqNo; 

// reserved command sequence number 
const CmdSeqNo AnyCmd = -1; 

const CmdSeqNo InvalidCmd = -1; 

struct Cmdld { 
30 Instid session; 

CmdSeqNo . seqNo; 

\ ; 

// element manager base application programming interface exception 
35 cedes 

enum EmapiExceptionCode { 

EM_INVALID_USER, 

EM_U*NKNOWN_HOST , 

EM_TOO_MANYJJSER_S ESS IONS, . 

EM_TOO_MANY_AP P LI CAT IONS , 
40 EM_INVALID_SESSION_ID, 

EM_I NVALI D_APP_I D , 

EM_INVALID_INST_ID, 

EM INVALID_NE'_ID, 

EM ^ I NVAL I D_MO _ I D , 
45 EM_ I NVAL I D_ATT R_CO DE , 

- e>Tno_matching_inst, 

EM_I NVALI D_FI LTER , 
EM_ I NVAL I D_FI LT ER_ I D , 
£M_NE_ISOLATED, 
EM_I NT ERNAL_ERROR , 
EM_ I NVAL I D_0 P E RAT I ON , 
EM_ACCESS_DENIED, 
EM_VERSION_MISMATCH, 
EM_LOST_RESOURCE, 
EM_INVALID_KEY, 
55 EM INVALID CATEGORY 
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} ; 

// element manager exception 

exception EmapiException { EmapiExceptionCode errCode; }; 
// Access permissions: 

// For now, permission is granted on a network element basis: 

// on any kind of access 

// on status information access 

// on maintenance operation access 

// The network element basis can be: 

// on any network element 

// Oid: { AnyClass, Anylns tance } 

/ / on any instance of a particular network element type 

// Oid: { <class> / Anylnstance } 

// on a specific instance of a particular network element 

type 

// Oid: (<class>,<instance>| 

// Kinds of Access (set to be manageable by using a bit map/mask) : 
typedef Asnllnteger AccessType; 



25 



30 



const AccessType 
const AccessType 
const AccessType 
const AccessType 
//const AccessType 
//const AccessType 
//const AccessType 



AnyAccess = -1; 
NoAccess = 0; 
StatusAccess = 1; 
OperationAccess = 2; 
NextAccess = 4; 
AfterThat = 8 
AfterThat =16 



// 



, and so on, in powers of 2 



// AccessPermission structure: 



// accessible 

// accessType 

// oid 
access 



TRUE or FALSE for this type of access 
type of access 

network element involved in this type of 



35 



40 



struct AccessPermission { 

boolean accessible; 
AccessType accessType; 
Oid oid; 

I; 

// Application registration results in the client's receiving a 
sequence of 

// AccessPermission blocks. 



45 



50 



typedef sequence<AccessPermission> 



SeqAccess Permission; 



struct AccessPermissionList { 

SessionAppId ses si onAppId ; 

SeqAccess Permission seqAccess Permission ; 

} ; 



// user session 

interface UserSession { 
// Null Session 
const Instld 



NullSession 



= 0; 



55 



12 



BNSDOCID: <EP 0998076A1 I > 



EP 0 998 076 A1 



// maximum number of sessions per system 

const short MaxUserSessions = 32; 

5 // heartbeat period in seconds (Applications should use this 

value to 

// time their heartbeats with the server. ) 

const long HeartbeatPeriod = 5; 

// client . application registration: must be called once per 
io // application. 

// 

// INPUTS : ~ 

// applicationName : determined by client application 

// host: name of host on which client is running 

// user: login id 

//, . passwd: user's password 

//RETURNS: 

// unique id for this session's application 

// plus a sequence of Access Permission blocks 

// showing what is accessible from this application 

// NOTE: The client's responsibility to delete the returned 

pointer 

// 

/ / THROWS : 

// EM_TOO_MANY_S ESS IONS 

// EM_TOO_MANY_APPLICATIONS 
AccessPermissionList s tartApplication ( 
in string host, 
in string user, 
in string passwd, 
in string applicationName ) 
30 raises (EmapiException) ; 

// client deregist ration — entire session 

// 

// INPUT: a session application id 

// 

// THROWS: 
// EM_INVALID_SESSION_ID 

void stop (in Instld sessionld) raises ( EmapiException ) ; 

// client deregist ration — single application 

40 // 

// INPUT: a session application id 

// 

// THROWS: 

// EM_INVALID_SE5SI0N_ID 
// EM_INVALID_APPLICATION_ID 
_ void stopApplication ( in SessionAppId id) 
raises (EmapiException) ; 



i5 



20 



25 



35 



45 



// client heartbeat 

// 

50 // INPUT: session application id 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 

// EM_INVALID_APP_ID 

55 // EM_ I NT E RNAL_ ERROR 
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) ; 



void heartbeat (in SessionAppId id) raises ( EmapiException) ; 



10 



15 



20 



// 

// Managed Object definition. The Managed Object (MO) describes 
definitions 

// and operations that are common to all application specific managed 

// objects in the system. 

// 

interface MO { 

// All attributes of an MO are identified by integer constant 
// codes called AttrCodes . 

typedef long AttrCode; 

const AttrCode NullAttrCode = -1; 

// 

// The^ following attribute codes are reserved and are used 
// by the MO implementation. Clients should always use the 
// attribute codes found in the application specific managed 
// object definition (e.g. ApModule . idl ) and not these. 

// 

const AttrCode moInstanceCode = 0; 

const AttrCode nelnstanceCode = 1; 

const AttrCode LastReservedCode= 1; 



25 



// clients register for updates by specifying a sequence of 
// attribute codes 

typedef sequence<AttrCode> SeqAttrCode; 



30 



35 



40 



// The atrribute value is a discriminated union of scalars 
// All basic types currently supported by the EMS are 
described 



// here, 
typedef long 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType' 



AttrType; 

Vallnstld 

ValAsnl Boolean 

ValAsnl Integer 

ValAsnlUInteger 

ValAsnlOctet 

ValAsnlTime ticks 

ValAsnlGauge 

ValAsnlCounter 

ValAsnl IpAddress 

ValAsnlNull 

ValAsnlOid 

ValLogicalld 



1; 
2; 
3; 
4; 
5; 
6; 
7; 
8; 
9; 
10; 

11; 
12; 



45 



50 



55 



i I 

//. Th€ 
// in 

// 



following union defines all possible attribute types 
the EMS. 



AttrValue switch (AttrType ] 
case Vallnstld: 
case ValAsnlBoolean: 
case ValAsnllnteger : 
case ValAsnlUInteger: 
case ValAsnlOctet: 
case ValAsnlTime ticks : 
case ValAsnlGauge: 



{ 

Instld 

AsnlBoolean 

Asnllnteger 

AsnlUInteger 

AsnlOctet 

As nlTime ticks 

AsnlGauge 



instld; 

asnlBoolean; 

asnllnteger; 

asnlUInteger; 

asnlOctet ; 

asnlTimeticks ; 

asnlGauge; 
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case ValAsnlCounter : AsniCounter asnlCounter; 
case ValAsnllpAddress : Asnl IpAddress asnllpAddress ; 
case ValAsnlNull: AsnlNull asnlNull; 

case ValAsnlOid: AsnlOid asnlOid; 

case ValLogicalld: Logicalld logicalld; 

) ; 

// 

// each set of updates on a managed object is delivered 

// as a sequence of attribute- value pairs ( SeqAttrCodeValue ) . 

ft 

struct AttrCodeValue { 

AttrCode code; 
AttrValue value; 

} ) 

typedef sequence<AttrCodeValue> SeqAttrCodeValue; 

m t - 

// 

// The getAttrlnfo method of the MO returns a sequence of 
// information that describes each available attribute. 

// 

struct Attrlnfd { 

AttrCode code; 

AttrType type; // note: currently not 

populated 

Asnl Octet name; 

}; 

typedef sequence<AttrInf o> SeqAttrlnfo; 

// 

// Config update notifications (via the deliverConf ig method 

in the 

// ConfigCB) can take two forms. 

// 1) One or more managed object instances have been 

created . 

// (CONFIG_CREATE) . 

// 2) One or more managed object instances have been 

deleted 

// (CONFIG_DELETE) . 

// 

enum Conf igNotif yType { 

CONFIG_CREATE, // a new MO instance has been created 
CONFIG_DELETE // an existing MO instance has been 

deleted. 

>'■ " 
// 

// Status update notifications (via the deliverStatus method 
// StatusCB) can take two forms. 

// 1) An initial update < STATUS_JCNIT) that is returned 

// as a result of a getStatus or as the initial status 

// a startUpdate request. 

// 2) An inremental update { STATU S_CHANGE) representing a 



in the-- 

either 
from 

change 
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10 



20 



30 



40 



50 



// to one or more of the attributes that the client 

registered for. 
// 

enum StatusNotif yType { 

STATUS^INIT, // represents initial status update of 



all 

startUpdate) 
update 

); 



// requested attributes {e.g. 

S T ATU S _C HANG E // represents an incremental status 

// (contains 1 only' attributes that have 

// changed) . 



ts // 

/ / each ccnfig update notification will be delivered as a 
sequence of : 

// network element instance id 

// managed object key list (sequence of attr- 

value pairs) 

// managed object instance id 

struct ConfigData { 

Instld nelnst; 
SeqAttrCodeValue keyList; 
Instld molnst ; 

}; 

typedef sequence<Conf igData> SeqConf igDa ta ; 

// 

// viewConf ig ( ) - obtain EMS view of the current managed 

ob] ect 

// configuration for a specified network element 

ins tance . 

// The special value Anylnstance may be used to obtain 

// configuration information for all network elements 

35 known 

// to the EMS. 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

per form 

// the operation . 

// nelnst - specific NE instance identifier, or 

Anylnstance 

// to get config for all ME instances. 

45 // RETURNS : 

// A sequence of configuration information (sequence 

length 

// is proportional to the number of configured MO 

instances ) . 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// EM_INVALID_INST_ID 

55 // 
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SeqConf igData viewConf ig ( in SessionAppId sessionAppId, 

in Instld nelnst) 
raises ( EmapiException) ; 

5 // 

// notif yConf ig ( ) - Client registration for managed object 
// configuration information for specified network 

element 

// instance (or the Anylnstance to register for 

10 notifications 

// on all network element instances )„. The current 

snapshot 

// of configuration is returned (like viewConfig) and all 

//. subsequent configuration changes result in an 

invocation of 

// the specified callback. 

• - // v 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

20 // used to validate client permission to 

perform 

// the operation . 

// nelnst - specific NE instance identifier, or 

Anylnstance 

// to get config for all NE instances. 

// callback - client callback (implements the 

Conf igCB 

// interface) that will be invoked for 

all 

// config changes . 

30 // RETURNS: 

// A sequence of configuration information (sequence 

length 

// is proportional to the number of configured MO 

instances ) . 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID__SESSION_ID 

// EM_INVALID APP_ID 

// EM_INVALID~INST_ID 
40 // 

SeqConf igData notif yConfig ( in SessionAppId sessionAppId, 

in Instld nelnst, 
in ConfigCB callback) 
raises (EmapiException) ; 

// 

--// cancelNotify ( ) - Cancel all requests for configuration 

change 

// notifications associated with the specified client 

application. 
50 // 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

55 perform 



35 



17 



BNSDOCID: <EP 0998076A1J_> 



15 



25 



EP 0 998 076 A1 

// the operation. 

// RETURNS: 
// void 

5 U 

// THROWS: 

/ / EM_INVALI D_SES S ION JC D 

// EM INVALID APP ID 

// "~ 

void cancelNotif y ( in SessionAppId sessionAppId) 
10 raises { EmapiException) ; 

// 

// getPersistent ( ) - Obtain the attribute codes for all 
persistent 

// attributes maintained by this managed object. 

Persistent 

// attributes are those that the EMS keeps the current 

value 

// regardless of client registrations. Other attributes 

are 

20 // polled for only when a client makes a request or 

registers 

// for update notifications. 

// INPUTS : 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// a sequence of attribute codes representing the 

30 persistent 

// attributes. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

/ / EM_I NVAL I D_S ESSI ON_I D 

// EM_INVALID_APP_ID 

// 

SeqAttrCode getPersistent ( in SessionAppId sessionAppId) 

raises ( EmapiException) ; 

40 // 

// getAttrSpec ( ) - Return identification of attributes that 

are 

// defined for the specific managed object instance. A 

sequence 

// containing the attribute name {an OCTET representing 

the 

// ASCII string name) and the associated attribute code 

/ / is returned . 

// 

// INPUTS: 

50 // sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

55 // RETURNS: 



35 



45 
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// A sequence of attribute info representing the 

attribute names and codes. 
// CALLER MUST DELETE RETURNED MEMORY. 

// 

5 // THROWS: 

// EM_INVALID_SESSlON_ID 
// EM_ I NVALI D_AP P__ I D 

// 

SeqAttrlnfo getAttrSpec ( in SessionAppId sessionAppId) 
10 raises ( Elmapi Exception ) ; 

// 

// getKeySpec() - Return identification of key attributes. A 

sequence 

// of attribute codes representing the keys is returned. 

Note 

// J "> that the sequence will be in the order defined in the 
// MOview. 

// 

// INPUTS: 

20 // sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// A sequence of attribute codes. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
30 // EM_ I NVALI D_AP P_ I D 

// 

SeqAttrCode getKeySpec (in SessionAppId sessionAppId) 

raises ( EmapiException ) ; 



25 



35 



// 

// viewStatusO - obtain EMS "view" of the values of the 
specified 

// persistent attributes. 

// INPUTS: 

// sessionAppId - client session/application identifier. 

40 This is 

// used to validate client permission to 

perform 

// the operation. 

// instld ' - MO instance. This specifies the MO 



45 



whose 



be 



// attributes are to be examined. 

-7/ attrList - sequence of attribute codes that are to 



// viewed. 
// RETURNS: 

50 // a sequence of attribute code/value pairs representing 



the 



// current view of the attribute values, 

// CALLER MUST DELETE RETURNED MEMORY. 

// 



55 
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15 



35 



// THROWS: 

// EM_INVALID_SESSION_ID 

// EM_INVALID_APP_ID 

/ / EM_INVALI D_INST_I D 

// EM_ I NVAL I D_MO_ I D 

// EM INVALID ATTR CODE 

// ~ 

SeqAttrCodeValue viewStatus (in SessionAppId sessionAppId, 

in Instld instld, 
in SeqAttrCode attrList) 
raises ( Emapi Exception ) ; 



be 



// 

// getStatusO - request for a snapshot of current status 
// information. This differs from viewStatus in that 

attrList 

// ■ may specify any managed object attribute codes, and 

the 

// information is returned via client callback. The 

callback is 

20 // used because the request may require a get request to 

the 

// network element. 

// 

// INPUTS: 

25 // sessionAppId - client session/application identifier. 

This is 

used to validate client permission to 

perform 

// the operation. 

// instld - MO instance. This specifies the MO 

30 attributes are to be examined. 

// attrList - sequence of attribute codes that are to 

// retrieved. 
// RETURNS: 
// void 

// 

// THROWS: 

// EM_INVALID_SESSI0N_ID 
// EM_INVALID_APP_ID 
/ / EM_INVALI D_INST_I D 

40 // EM_ I NVAL I D_MO_ I D 

// EM_INVALID ATTR CODE 

// 

void getstatus (,in SessionAppId sessionAppId, 
in Instld instld, 
45 in SeqAttrCode attrList, 

in StatusCB callback) 
raises (EmapiException) ; 

// 

// startUpdate ( ) - client registration for notifications of 
50 // any updates to the values of the specified set of 

attributes . 

// An initial snapshot of all requested attributes is 

// delivered first (type=STATUS_INIT) followed by 

notifications 

55 
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15 



20 



25 



30 



35 



40 



45 



50 



55 



// of only those attributes that have changed 

( type=STATUS_CHANGE) 

// Note that this method may result in polling to the 

network 
and 



// 
// 



element, but only if the attributes are not persistent 

no other clients have issued a startUpdate for the 
attributes (only a single poll is used for all 
registered 



// 
// 

// INPUTS 



clients) 



This is 



perform 



// 

// 

//' 
// 

// 



sessionAppId 

instld 
attrList 



be 



client session/application identifier, 
used to validate client permission no 

the operation. 
MO instance. This specifies the MO 

whose attributes are to be examined, 
sequence of attribute codes that are to 

monitored. 



Cancel 
client 
number 
this 



// 

// RETURNS: 
// void 
// 

// THROWS: 

// EM_IMVALID_SESSION_ID 

// EM__INVALID_APP_ID 

// EM_INVALID__INST_ID 

// EM_I NVAL I D_MO_ I D 

/ / EM__I NVAL I D_ATT R_CO D E 

// 

void startUpdate ( in SessionAppId sessionAppId, 
in Instld instld, 
in SeqAttrCode attrList, 
in StatusCB callback) 
raises ( Emapi Exception ) ; 

// 

// stopUpdate() - client deregistration for status updates. 
// all monitoring activity associated with the specified 

// application. Note that the client may have issued a 

// of startUpdate requests for different instances, but 

// single call to stopUpdate will cancel all of those 



requests . 

-// 
// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 
// void 
// 
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// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 

void stopUpdate (in SessionAppId sessionAppId) 
raises (EmapiException) ; 

// 

// getlnst{) - return the instance identifier associated with 

the 

10 // specified keys. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// ' the operation. 

// nelnst - the network element instance identifier 

of the 

// NE that contains the managed object 

20 instance 

// specified by the keys. 

// RETURNS : 

// the Instld of the managed object, or Nulllnstance if 

not found. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// EM_INVALID_INST_ID 

// 

Instld getlnst(in SessionAppId sessionAppId, 
in Instld nelnst, 
in SeqAttrCode Value keyValues) 
raises (EmapiException) ; 

} ; 

35 

// 

// client callback for managed object configuration reporting 

// 

interface ConfigCB { 

oneway void del i verConf ig (in ClassCode classld, 
40 in MO: : Conf igNotif yType type, 

in MO: : SeqConf igData config); 

} ; 
// 

4S // client callback for managed object status reporting 

// 

interface StatusCB I 

oneway void deliverStatus (in Oid oid, 

in MO: : StatusNotif yType type, 
in MO: : SeqAttrCodeValue 

attrValList) ; 
} ; 

// network element level managed object 
interface NEMO : MO { 

55 



25 



30 



SO 
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// attribute code reserved for boolean network element 

// isolation indication. 

const AttrCode IsolatedCode = 1; 

5 // 

// each network level configuration update notification is 
delivered 

// as a sequence of: 

// network element instance id 

70 // network element logical id 

struct NEconfigData { . 

Instld instld; 
Logical Id logical Id; 

}; 

is typedef sequence<NEconf igData> SeqNEconf igData; 

// ' ? 

// Sequence of containment information describing all 

// contained managed objects. 

// 

20 struct Containment Info ( 

ClassCode classCode; 
MO moRef; 
AsnlOctet name; 

} ; 



25 



30 



per term 
35 



typedef sequence<ContainmentInf o> SeqContainment Inf o; 

// 

// viewNEeonf ig ( ) - obtain EMS view of current network element 
// configuration 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 



// the operation. 

// RETURNS: 

// Sequence of network element configuration information. 

// CALLER MUST DELETE RETURNED MEMORY. 



// 

40 // THROWS: 



45 



// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 

// , 

SeqNEconf igData viewNEeonf ig ( in SessionAppId sessionAppId) 

raises ( EmapiException ) ; 



* // 

// not if yNEconf ig ( ) - client registration for network level 
// managed object configuration. An initial snapshot of 

// the network element level configuration is returned. 

50 // All subsequent changes to the network element 

configuration are delivered via the specified callback. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

55 This is 
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// used to validate client permission to 

perform 

// the operation. 

// callback - callback object that is to receive 

delivery 

// of changes to configuration. 

// RETURNS: 

// Sequence of network element configuration information. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 

ft' 

15 SeqNEconf igData notif yNEconf ig (in SessionAppId sessionAppId, 

in NEconfigCB callback) 
raises ( EmapiException) ; 



10 



20 



30 



// 

// cancelNEnotif y ( ) - cancel request for NE configuration 

change notifications 
// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

25 // used to validate client permission to 

perform 

// the operation. 

// RETURNS: 
// void 
// 

// THROWS: 
// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 

// 

void cancelNEnotif y ( in SessionAppId sessionAppId) 
35 raises (EmapiException) ; 

// 

// getNEInst() - return the network element instance 
identi f ier 

// associated with the specified NE logical identifier. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

45 perform 

// the operation. 

// * logicalld - the logical identifier (integer) of 

the network element. 

// RETURNS: 

// the Instld of the network element instance, or 

Nulllnstance 

// if not found. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
55 //EM INVALID APP ID 



40 



50 
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// 

Instld getNEinst (in SessionAppId sessionAppId, 
in Logicalld iogicalld) 
s raises ( Emapi Exception ) ; 

// 

// getLogicalld ( ) - return the NE logical identifier 

// associated with the specified instance identifier. 

// 

10 /I INPUTS: 

// nelnst - the instance identifier of the network 

element. 

// 

// . RETURNS : 

1S II the logical identifier of the network element 

instance, 

// *? or 0 if not found. 

// 

Asnllnteger getLogicalld ( in Instld nelnst); 

20 a 

II getContainment ( ) - return sequence with containment 
information 

// for this network element. The sequence returned 

contains 

25 II the name, class code and a pointer to the associated 

service 

// class object. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

30 This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// a sequence of containment information describing the 

contained 

// managed objects. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

4° II EM_INVALID_SESSION_ID 

// EM_INVALID_APP_ID 

// 

SeqContainmentl^if o getContainment ( in SessionAppId 
sessionAppId) 

45 raises ( EmapiException) ; 

}; 

// client callback for network element level managed object 
configuration 
// reporting 
interface NEconfigCB { 

oneway void deli verNEconf ig ( in ClassCode classld 

in NEMO: : Conf igNotif yType type, 
in NEMO: ; SeqNEconf igData config) 

55 I ; 
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30 



// typedefs for acknowledgement value & alarm level 
typedef Asnllnteger AckValue; 
typedef Asnllnteger AlarmLevel; 

// no alarm filtering conjunctions are permitted, but we do allow a 
single 

// filter to extract all alarmed notifications by defining an "out-of- 
band" 

// alarm level 

const AlarmLevel Any Alarm = - - 1 ; 



// typedef for event data structure— note that instance information 
may no 

75 // longer be valid when an event is processed, so key information 

should 

// always be available in the attribute-value list 
struct EventData { 

ClassCode classCode; 
MO: : SeqAttrCodeValue seqVal; 

) ; 

t ypede f sequence<EventData> SeqEventData ; 



// event distributor interface description 
interface EvtDist { 
25 // time of event as reported by EMS 

typedef long EventTime; 

// categories of events 
enum Category { 

ANY_EVENT, 
ALARM_CLEAR, 
ALAFM_SET, 
CMD_ACK, 
CMD_RESP, 
COMF1 G_CHANGE , 
35 INFOJ4SG, 

INIT_MSG, 
STAT EXCHANGE, 
NUM_CATEGORIES 

) ; 

40 // event header (not all members valid for all categories) 

struct Header { 

EventTime e ventTime ; 

Category category; 

Oid networkElemld; 
45 AlarmLevel networkElemAlm; 

Oid maintUnitld; 

AlarmLevel maintUnitldAlm; 

Cmdld cmdld; 

) ; 

50 // event filter (not all members valid for all categories) 

struct Filter { 

Category category; 

Oid networkElemld; 

AlarmLevel networkElemAlm; 
55 Oid maintUnitld; 
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AlarmLevel maintUnitldAlm; 
Cmdld cmdld; 

) ; 

// cookie for client registration/deregistration 
typedef long Filterld; 

// client registration for events 

// 

10 // INPUTS: ' 

// id: SesionAppId associated with the filter 

// filter: EvtDist :: Filter that specifies filter 

criteria 

// callback: EventCB that defines deli verEvent ( ) 

// operation that will be called when an 

// incoming event matches the filter 

// "RETURNS: 
// unique Filterld for this filter 

// 

// THROWS: 

20 // EM_INVALID_SESSION_ID 

// EM_INVALID_APP_ID 
/ / EM_ I NVAL I D_ CATEGORY 

Filterld registerFilter { in SessionAppId id, 

in Filter filter, 
n$ in EventCB callback) 

raises ( EmapiException) ; 

// client filter deregis tration 

// 

// INPUTS: 

30 // id: SesionAppId associated with the filter 

// to be cancelled 

// filterld: Filterld of the filter to be cancelled 

// 

// THROWS: 

// EM_INVALID_SESSI0N_ID 
// EM_INVALID_APP_ID 
// EM_INVALID_FILTER_ID 

void cancelFilter ( in SessionAppId id, 

in Filterld filterld) 
raises (EmapiException) ; 

40 ]; 

// client callback for event notification 
interface EventCB { 

45 // deliverEvent { ) is called by event distribution 

// software whenever an incoming event matches 
// a registered filter. 

// 

// INPUTS: 

// header: EvtDist :: Header associated with the 

50 // incoming event 

// data: SeqEventData (sequence of event data) 

// associated with the incoming 

// event 
// 

55 oneway void deliverEvent (in EvtDist :: Header header, 
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in SeqEventData data) ; 

// This empty operation is called during event filter 
s // auditing to determine wnether or not the associated 

// session/application is still active. If it has 
// terminated, a CORBA: : Sys temException will be thrown 
// and subsequently caught, indicating that the associated 
// filter should be removed from the filter queue. 

10 oneway void check () ; 

} ; 

// typedefs for alarm data structures 
struct AlarmRecord { 

15 Instld instld; // unique per alarm 

definition 

MO: :-SeqAttrCodeValue attrValList; 

} ; 

typedef sequence<AlarmRecord> SeqAlarmRecord; 

20 struct AlarmData { 

ClassCode alarmDef; 
SeqAlarmRecord alarmRecords ; 



25 



30 



35 



typedef sequence<AlarmData> SeqAlarmData ; 

// alarm notification type 

enum AlarmNotif yType { A1ARM_5 ET , ALARM_ CLEAR }; 

// active alarm manager interface description 
interface AlarmManager { 

// active alarm filter—note that logical ids are specified 

since 

// instance information may not be available at the time 
alarms are 

// reported 
struct AlarmFilter { 

ClassCode alarmDef; 
Logical Id networkElemld; 
ClassCode maintUnitCiass ; 

SeqLogicalld maintUnitld; 
AlarmLevel alarmLevel; 

40 ) ; 

// client registration for active alarms — both initial data & 

update 

// notifications (note that only one alarm filter can be 
registered 

// with the alarm manager by each client application) 
SeqAlarmData reques tAlarms {in SessionAppId ses sionAppId, 

in AlarmFilter filter, 
in AlarmCB callback) 
raises ( EmapiException ) ; 



45 



50 



// request to change filter criteria (note that only one alarm 

filter 

// can be registered with the alarm manager by each client 
application) 

55 SeqAlarmData changeFilter ( in SessionAppId ses s ionAppId, 
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alarms 
alarm 



in AlarmFilter filter) 
raises (EmapiException) ; 

// request to refresh alarm list — returns snapshot of current 

// (note that only one alarm filter can be registered with the 

// manager by each client application) 

SeqAlarmData ref reshAlarms ( in SessionAppId sessionAppId) 

raises (EmapiException) ; 

// client deregistration--cancel alarm set & clear forwarding 

to the 

// .specified client application (note that only one alarm 
filter can 

// be registered with the alarm manager by each client 
application)* ? 

void cancelAlarras (in SessionAppId sessionAppId) 
raises ( EmapiException) ; 

// request for a list of all alarms in the entire system or 
associated 

// with the indicated network element — supports the EMS 
version of the 

// "OP: ALARM" technician command 

CmdSeqNo opAlarrn(in SessionAppId sessionAppId, 
in ClassCode alarmDef, 
in Logicalld networkElemld, 
in EventCB ackCB, 
in EventCB cmdRespCB) 
raises (EmapiException) ; 

I ; 

// client callback for active alarm notification 
interface AlarmCB ( 

oneway void deli verAlarms { in AlarmNotif yType type, 

in AlarmData data) ; 

I ; 

// active alarms service object interface, derived from managed object 
// interface— note that no filtering of active alarms can be specified 
interface ActiveAlarms : MO { 

// system client (e.g., Active Alarm Manager) registration for 
// active alarms— both initial data and update notifications 
SeqAlarmRecord getAlarms(in SessionAppId sessionAppId, 

in AlarmCB callback) 
raises (EmapiException) ; 

// system client (e.g., Active Alarm Manager) deregistration — 
..// cancel active alarms update notifications 
void cancelAlarms ( in SessionAppId sessionAppId) 
raises (EmapiException) ; 

} ; 

Sendif // _EMAPI_IDL 
// EOF // 
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APPENDIX B-GLOSSARY 
Aiartn 



Attribute 
Attribute Code 

Class Code 

Configuration 
Information 



CORBA 
EMAPI 
EMS 
Event 

Instance Identifier 



The description of an alarmed notification. 
A property of a managed object (e.g. alarm state). 

An integer value which uniquely identifies an attribute of a given managed 
object. 

An integer value which uniquely identifies a managed object class. 

Generic term which has one of two meanings depending on its context: 

With respect to a managed object class, this term applies to the identification 
of all instances of the class, either for a specific network element or for all 
network elements in the system. 

With respect to a managed object instance, this term may apply to one or 
more attributes which are associated with database values, such as the 
primary/alternate role of a duplex component. 

Common Object Request Broker Architecture 

Element Management Application Programming Interface 

Element Management System 

The description of a spontaneous occurrence, such as alarm notification, 
command acknowledgment or configuration change. 

An integer value which uniquely identifies an instance of a given managed 
object. 



Interface Operation Generic term for distributed service request. The target method may be 

defined in the Element Management Application Programming Interface (e.g. 
status registration) or in an application-specific derivation of a managed 
object (e.g. command execution). 



Logical Identifier 

Managed Object 
ORB 

Object Identifier 



An integer value which represents the logical number of a device or interface 
(e.g. AP 4). Note that there is no direct correlation between a logical id and 
instance id. 

An abstract representation of a physical or logical resource which may be 
managed by the EMS (e.g. network element, maintenance unit, data link) 

Object Request Broker 

The combination of managed object class code and instance identifier which 
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uniquely identifies any managed object instance in the system. 

5 Persistent Attribute Information stored and kept current irrespective of any client request (e.g. 

maintenance state). 

Service Object Any EM Server object which provides services to client applications. 

10 Session Each client must establish a session at initialization—for which a unique 

session identifier is assigned— that will be used to validate access permissions, 
to correlate client requests and to keep track of Server resources utilized in 
behalf of any applications associated with the session. 

is Status Information Current attribute values for a managed object instance. 



Claims 

1. In a network having a controllable network element, a method for controlling the network element from a remote 
work station connectable to the network, comprising the steps of: 

registering the network element for attributes to be tracked; and 

polling for attributes associated with the network element only if the client requests the monitoring of the net- 
work element. 

2. The method of claim 1 wherein the polling is performed by the server. 

3. The method of claim 1 including the step of reporting changes in attributes when the client requests notification of 
changes in attributes. 

4. The method of claim 1 , including the steps of 
polling for the attributes for a plurality of clients, and 

reporting changes in the attributes to one of the plurality of clients requesting notification of changes in the 
attributes. 

5. The method of claim 4 wherein the step of polling includes the step of polling once for a plurality of clients that 
registers for the same attributes. 

6. The method of claim 5 including reporting asynchronously changes in the attributes to a plurality of clients. 

7. The method of claim 1 wherein the step of polling is performed in a single polling cycle when multiple clients have 
registered for the same attributes. 

8. The method of claim 7 including the steps of 

running an object oriented program at the remote work station to control an object associated with the con- 
trollable network element; 

translating interface operations generated by the work station during the running of the object oriented program 
55 to corresponding translated interface operations in an object oriented language associated with the object 

being controlled; and 

connecting the corresponding translated interface operations through the network to an object server to control 
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the object associated with the network element in accordance with the translated interface operations. 

9. The method of claim 8 in which step of translating includes the steps of 

automatically determining which of a plurality of different object oriented languages is the object oriented lan- 
guage of the object being controlled, and 

generating translated interface operations corresponding to the interface operations from the remote worksta- 
tion to the object server in accordance with the language of the object being controlled as has been automat- 
ically determined. 

10. The method of claim 8 in which the object oriented program run at the remote work station is a JAVA program. 

11. The method of claim 8 in which the network element is located at a node of the network and the step of translating 
includes the step of 

receiving the interface operations through a communication link of the network at a node separate from the 
node of the network element, 

translating the interface operation through the network communication link into the corresponding translated 
interface operations by converting the received interface operations into IPC and TCP/IP requests. 

12. The method of claim 11 in which the step of connecting includes the step of transmitting the IPC and TCP/IP 
requests to the object server. 

13. The method of claim 12 in which the step of connecting includes the step of generating the IPC and TCP/IP request 
through a web-based GUI. 

14. The method of claim 8 in which the object server responds to the translated object requests by 

gathering information concerning the network element, and conveying the information concerning the network 
node that has been gathered to the remote work station by at least by one of the ways of 

dynamically generating a web-page visual display associated with the network element being controlled for 
interfacing with the remote work station to display the gathered information. 

15. The method of claim 14 in which the step of gathering includes the step of gathering network element information 
concerning at least one of the items of network element information of 

a list of all active alarms, 

a summary of system alarms, and 

a detailed indication of the status of the network element. 

16. The method of claim 15 in which the step of gathering includes the step of selectively gathering all of the items of 
information. 

17. The method of claim 8 in which the step of translating includes the step of communication with the object server 
through a distributed object request architecture to provide a consistent interface to the managed object that hides 
implementation details associated with the object manager. 

18. The method of claim 17 in which the distributed object request architecture is CORBA architecture. 

19. The method of claim 8 in which the CORBA architecture functions as an IPC for functions residing on the object 
server to eliminate the need for platform specific language for the object oriented program at the remote station. 

20. The method of claim 8 in which the CORBA architecture functions as an IPC for functions residing on the object 



32 



EP 0 998 076 A1 



server to provide for distribution of functionality to multiple work station processors. 



21. The method of claim 8 in which communication between the network element and the object server is through use 
of a network management protocol. 

5 

22. The method of claim 1 wherein the network management protocol is the simple network management protocol. 

23. The method of claim 21 including the step of obtaining system status associated with the network element by 
polling and auditing pursuant to the simple network management protocol. 

w 

24. The method of claim 21 including the step of providing real-time notification, .of alarm conditions at the network 
element through the use of network management protocol event manager. 

25. The method of claim 21 including the step of providing command and control signals to the network element through 
1$ use of simple network management protocol set operation. 

26. The method of claim 8 in which 



the object server is part of an element management server that also includes a web server, and including the 
20 step of 

displaying command and alarm output information from the network element as a web browser-based display 
through use of the web server. 

25 27. The method of claim 26 in which 

the element management server also includes an executive control processor, and including the step of 

sending the command and alarm output information from the network element that is displayed through use 
30 of the web server to the executive control processor. 

28. The method of claim 1 2 including the steps of 

storing network element information concerning the network at the element management server, and 

35 

selectively providing the stored network element information to a plurality of different work stations. 

29. The method of claim 8 including the step of sending from the network element event and alarm notifications to the 
object server through use of a network management protocol. 

40 

30. The method of claim 29 including the step of issuing commands from the network element to obtain input information 
from the work station running the object oriented program to the object server through the use of the network 
management protocol. 
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